CY3€R 180 OEV£LQPHENT 

ERS for PASCAL Extended Formatter 



5/19/78 

rev: B 



EXTERNAL REFERENCE S PECIF IC ATiaN 
FOR 
INTERIH PASCAL EXTENDED FORHATTER V0,0 



Sub mi tteds 



Approved « 



H* A« Wohlwend 



P. W« Haynes 



E« LaRowe 



R« A« Peterson 



DISCLAIHER: 

This document Is an Internal working 
paper only. It Is unapproved and 
subject to change^ and does not 
necessarily represent any official 
intent on the part of CDC* 



COMPANY PRIVATE 



CyagR 180 OEVeiOPMENT 

ERS for PASCAL Extended Formatter 

REVISIOH OgFINITION SHEET 



5/19/78 

Re\/: 8 



REV 



0AT6 



DESCRIPTION 



04/07/78 
05/19/78 



Original* 

Updated to reflect conimefits received 
the DCS review* 



through 



COMPANY PRIVATE 



CYBER 180 DEVELOPMENT 

5/19/78 
ERS for PASCAL Extendad Formatter REVi 8 

1.0 PREFACE 



1.0 £g££AC£ 



The PASCAL-X source code formatter described in this document 
is based on past experiences developing and using comparable 
formatters for the ISWL and SWL languages. 



1.1 iaQE£.a£-i2Q£a!i£M 



This document is intended to contain information necessary to 
use the PASCAL Extended formatter in an Interactive or batch 
job. 

It is assumed that the reader is familiar with the PASCAL-X 
language and concepts of the NOS operating system* 



1.2 A££LIlI48L£^aaaUil£liIS 

PASCAL Extended Language Specification (ARH2298) 
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2.0 INTRODUCTION 



2.0 iMiaQauciiQM 



The PASCAL Extended formatter is a utility used to forfiiat 
PASCAL-X source code* It executes as a standalone product. 



2.1 £Ua£QS£. 



The formatter provides a common tool for formatting PASCAL^X 

source code prior to compilation* PASCAL-X programs formatted by 

a common tool will be more consistent* readable and 
maintainable* 



2.2 Q^EEKIiM 

The formatter Is executed as an absolute file. Input and 
output for the formatter are specified with a NOS control card* 
Formatting may be controlled to a limited extent by the use of 

PASCAL~X pragmats. 
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3,0 CONyEHTIQMS 



3*0 aaMMEI^IIQl^S 



The formatting conventions are mostly hard coded into the 
foffnatter viith some conventions being alterable by the use of 
pr agmats* 



3,1 Ili£yi>£iL£«ai2!l££N[IiQMi 

1) Source naust be normal PASCAL~X inpyt files ^currently the NOS 
6/12 character set). 

2) Source tnust be legitimate PASCAL-X source* but is not 
necessarily a compilation unit* Common decks are 
forma ttab I e« 

3) Source file is assumed positioned and local, 

4) Only one record on source file is formatted* 

5) Source line may be any length as formatter reads to 
end~of-l i ne* 

3 * 2 £a£i!i4II£Q«QUHyi-£IL£>aaM^£MIIQNi 

1) All lines will be 79 characters or less unless altered by a 

pr agmat • 

2) The character set output by the formatter will be identical 
to the input file character set* 

3) The formatted output file is created as a local file and is 

not rewound before or after, 

4) The output file will always start with 1 blank line* 
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3,0 CONVENTIONS 

3,3 FORMATTIHS COMVENTIONS 



3.3 £aSllAIIIiiS-£a!iI£liIIQilS 

IJ All keywords wl H be converted to upper case ynless altered 
by pragniat. The predefined data types like integer* char* 
cell* boolean* string* array* record* and set Hill always be 
in loner case. 

2) All programmer created identifiers will be converted to 
lower case unless altered by pragmat* 

3) The case of strings and comments will not be altered. 

4) Comments starting at the left hand margin will not be 
formatted. 

5) Lines with the asterisk control character In column one are 
not formatted* These lines are assumed to be maintenance 
package control statements which will be satisfied before 
comp 11 at I on. 

6) Blank or empty lines are retained. 

7) Blanks are squeezed to 1 except within strings and 
commen ts« 

8) A I I semi colon) will cause a new line to be started. If a 
trailing comment follows on that same line* it will remain 
ther e. 

9) A space will be added before and/or after certain 
delimiters. Such as: C and 3 on attribute lists* the 
operators* etc* 

10) Keywords that start or terminate a structured statement will 
star t a new line. 

11) Keywords that form a structured statement will cause 
following statements to have a margin of 2 greater than the 
line that contains the KEYWORD. Keywords that terminate a 
structured statement will decrease this margin by 2. The 
maximum margin will be 40. 

12) If there is no blank line before a VAR* TYPE* CONST* or 
PROCEDURE statement* or label* one will be put there* A 
blank line will separate a local variable declaration from 
the procedure statement list. 
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3.0 CONVENTIONS 

3,3 FORMATTING CONVENTIONS 



13) Each parameter decl ar a 1 1 on wM I start a new line when they 
appear within a PROCEDURE declaration. The VAR or valye 
attribute will have a margin two spaces greater than the 
margin for the PROCEDURE statement* The maxitnum margin will 
be 40, 

14) Identifiers defined in TYPE* VAR, and CONST statements will 
each start on a new line* 

15) Labels are backed up 2 colurpns from current margin and are 
a I one on a H ne« 

16) If comments need to be separated across lines, they will be 
separated at a blank and subsequent lines will be lined up 
with the original line* 

17) If comments starting at the left hand margin are too long, 
they are continued at the left hand margin of succeeding 
lines until the comment is completed. 

13) The left hand column defaults to 1 unless altered by a 
pragmat. The starting margin is equal to the left hand 

col umn • 

NOTE! The first input line is given a margin of 1. 

19) Pragmats that are processed by the formatter take effect 
after their appearance in the source* 

20) The formatter checks column one of the input stream and if 
it is non-numeric or the asterisk control character, the 
information is assumed to be text* 

21) The formatter stops execution and outputs an appropriate 
message upon detecting the first syntax error* The status 
of the output file is undefined, 

22) The THEN clause of the IF statement will normally be on the 
same line as the IF, space permitting* 

23) The ELSE and IFENO clauses are aligned with the IF 
statement • 

24) CASE selection specs will have the same margin as their 
associated CASE statement* 

25) Statements that exceed the length of a line will be 
continued on the following line with a 2 character 
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3.0 CONVENTIONS 

3*3 FORMATTING CONVENTIONS 



I ndentat i on* 

Z6) Long strings that do not fit on a single line will be split 
and the CAT operator generated* 



3*4 liiSSEMiatiS 



The following list of formatting features will not be done by 
the interim formatter » but should be strongly considered for the 
ultimate PASCAL~X formatter. 

Formatting of PLs* 

Filling in the labels on ending delimiters of labeled 
structured statements* procends and modends* 

Verifying that if the 4th character of a name is a $ sign* 
then the 3rd character must conform to the C180 System 
Interface Standard* 

Enforcing C180 coding conventions as they are defined* This 
includes capitalization of key^^ords and user defined 
i dent i f i er s* 

Recognition and justification of comments within a comment 
ol ock* 

o Oevelop a method of highlighting changes in flow of execution 
caused by the EXIT, CYCLE and RETURN statements. 

Investigate readability of tabbing the *:• in a type> 
variable* field or parameter specification to a fixed 
pos i t i on . 
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4*0 PRAGHATS 



4,0 £gifiBiIS 



Pragmats appearing in the source are used to control the 
PASCAL-X formatter and will be copied to output to provide a 
graceful means of reformatting. 

4,1 £iiG.4Lr.K-.£E4£llAIS 



These PASCAL-X pragmats control the PASCAL-X compiler as well 
as the formatter* 



4.1*1 ??RIGHT := N?? 



For the PASCAL-X formatter* this pragmat is used to specify 

maximum output line length with n >» 72 and <« 110. The default 

value is 19* This pragmat indicates to the PA3CAL-X compiler the 
maximum length of a source line* 



4, 1,2 ??LEFT : « N?? 



Used to make the PASCAL-X compiler and formatter Ignore any 
foreign data outside the PASCAL-X syntax. For the formatter* 
this pragmat indicates left hand output column and starting 
margin. The default value is 1* The foreign data which exists 
in the ignored column positions will be copied to the output 
file. 



4*2 FgRMiiss-aai^aii 

This pragmat controls only the PASCAL-X formatter and is not 
processed by the PASCAL-X compiler. 
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4.0 PRASNATS 
4,2*1 SYNTAX 

tm m tm *» mum tm m M M 19 m < 



4*2,1 SYNTAX 

<forinatter pragmat stateii}ent> 5S» ??<forraatter pragniat>?? 

<foriBatter pragfnat> Js= ftll (<toggle setting Hst>) 

<toggie setting list> iJ« <toggle setting> C><toggle setting>1 

<toggle setting> ::* <toggle identifier> s« <conditlon> 

<toggle identifler> J!= FORHAT \ KEYW T lOENT 

<condition> !?« m. J fl££ J U£E£E J LQMES 

4.2*2 TOGGLE IDENTIFIERS 

FQRHAT 

Used to control formatting of ali lines. Default is FORMAT s* 

ON* 

FORMAT 5= ON - Ail source lines are formatted* 

FORMAT s == OFF -No source lines are formatted. 

0) KEYW 

Used to control capitalization of keywords* Default KEYW J- 
UPPER. 

KEYW J« UPPER - All Keywords will be upper case* 

KEYW := LOWER - All keywords will be lower case* 

IDENT 

Used to control capitalization of identifiers. Default lOENT 
:« LOWER* 

IDENT :a UPPER - All identifiers will be upper case* 

IDENT s= LOWER - All identifiers will be lower case* 
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5.0 ys£-.a£-£aEHAiii.g 



l: 



0: 



The PASCAL-X formatter is executed as an absolute file. 

ATTACH>PASF0RH/yN«LP3 

PASFORHCC<I«f 1 lenam9>]C<f a«f il ename> ) 1 

Specifies the name of the file to be formatted* If 
I Is not specified? the name of the file is I. 

Specifies the name for the formatted file* If is 
not specified* the name of the file Is 0* 



lOTEJ I and may not use the same file name. 
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6.0 £ilia£L£l 



6.1 iQyac£«EiiOsaM 



1) ??RIGHT := 110?? 
naOULE Hll 

PROCEDURE All 

VAR IS integer; 

PROCENO Al,; 
HO DEN lii; 

Formatted Is? 

??RIGHT J* 110?? 

NODULE ni; 

PROCEDURE Al; 

VAR 

I J INTEGER? 
PROCENO Al; 
liODEND Ml; 

2) ??RIGHT !« 72?? 
MODULE Ml; 

PROCEDURE Al; 

VAR 

u integer; 

CONST J«5; 
PRQCEND Al; 
MODEMO Ml; 

Formatted iss 

??RIGHT J= 72?? 
MODULE Ml; 

PROCEDURE Al; 

VAR 

I: INTEGER; 
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6*0 EXAHPLES 

6.1 SOURCE PRQGRAH 



CONST 

PRQCENO Al5 
HODEND M15 



6.2 caMiaQL«£A£M 



GET#I«SOURCE* 
ATTACH^PASF0RH/UN«LP3, 
PASFORM, 
REPLAC£#Q*COHPILE. 

The file CQHPIIE will contain the formatted program found on 
f i le SOURCE* 



6,3 a£SiA££2i 

Hessages are written to the OUTPUT fHe and the dayfire* The 
somrce line that caused the error message will norniaHy be the 
last one on the output fHe» 

1) *t*UNBAlANCEO 310CK STRUCTURE^t* 

Begin and end statements for structured statements do not 
match, 

2) 'i'^^IHPROPeR PARAMETER LIST*** 

Sofnething is wrong with a PROCEDURE definition statement. 

3) ***EXTRAN£OUS RIGHT PARENTHESIS*** 
Right and left parens do not match, 

4) ***f1ISSI^G RIGHT PARENTHESIS*** 
Right and left parens do not match. 

5) ***IMPRQPER CASE LABEL*** 
Improper case statement* 

6) ***IfiPROPER PRAGHAT*** 
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6*0 EXAHPLES 
6.3 MESSAGES 



Soroethi ng is wrong with a pragmat that the PASCAl-X formatter 
pr ocesses* 

7) *4c4ciMPRaPER HEX CQNSTAHT^t* 
Soiaettilng is wrong with a hex constant* 

8) t^^IDENTIFIER TOO LONG*** 

Have an Identifier greater than 31 characters* 

9) ***IMPRaP£R STRING CONSTANT*** 

A quote is missing at EOL causing a syntactic error* 
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